Macros/pt

Introdução

Macros são uma forma conveniente de reproduzir tarefas complexas no FreeCAD. Simplesmente grava uma sequência de acções à medida que as executa, depois grava essa sequência com um nome, e já pode repetir a sequência quando quiser. Uma vez que Macros são realmente uma sequência de comandos Python, pode editá-los, e criar scripts muito complexos.

Uma vez que os scripts Python normalmente têm uma extensão de ficheiro .py, as Macros FreeCAD devem ter a extensão .FCMacro. Uma colecção de Macros escrita por utilizadoes experientes encontra-se na página Receitas de Macros.

Consulte a Central de usuários avançados para saber mais sobre a linguagem de programação Python e sobre a criação de macros. Em particular, você deve começar por estas páginas:

• Introdução ao Python
• Tutorial de scripts em Python
• Noções básicas de scripts no FreeCAD

Como funciona

Ative a saída do console no menu Editar → Preferências → Python → Macro → Mostrar comandos de script no console Python. Verás que, no FreeCAD, cada ação realizada — como pressionar um botão — gera um comando Python. São esses comandos que podem ser gravados numa macro. A principal ferramenta para criar macros é a barra de ferramentas de macros: . Nela, encontras quatro botões: gravar, parar gravação, editar e executar a macro atual.

É muito simples de usar: pressiona o botão de gravação, da um nome à tua macro e, em seguida, executa algumas ações. Quando terminar, clique no botão de parar a gravação e tuas ações serão salvas. Agora podes acessar a janela da macro usando o botão de edição.

Lá, podes gerenciar as tuas macros, bem como excluir, editar, duplicar, instalar ou criar novas do zero. Ao editar uma macro, ela é aberta numa janela de edição onde podes modificar o código. Podes instalar novas macros usando o botão "Addons...", que direciona para o Gerenciador de Complementos.

Exemplo

Pressiona o botão de gravação, dá um nome á macro — Renomeia, "cilindro 10x10" -Em seguida, na Bancada de Trabalho Part, cria um cilindro com raio = 10 e altura = 10. Depois, pressiona o botão "parar gravação". Na caixa de diálogo de edição de macros, podes visualizar o código Python que foi gravado e, se desejares, fazer alterações no código. Para executar a macro, basta pressionar o botão de execução na barra de ferramentas enquanto a macro estiver aberta no editor. A tua macro é sempre salva no disco; portanto, qualquer alteração feita ou qualquer nova macro criada estará disponível na próxima vez que iniciares o FreeCAD.

Personalização

É claro que não é prático carregar uma macro no editor sempre que a vais utilizar. O FreeCAD oferece formas muito simples de usar uma macro, como atribuir-lhe um atalho de teclado ou criar uma entrada no menu. Depois de criares a macro, tudo isso pode ser feito por meio do menu Ferramentas → Personalizar.

Dessa forma, podes transformar a tua macro numa ferramenta de verdade, como qualquer ferramenta padrão do FreeCAD. Isso, somado ao poder dos scripts em Python no FreeCAD, permite adicionar facilmente as tuas próprias ferramentas à interface.

See Customize Toolbars for a more detailed description.

Criar macros sem gravação

Podes também copiar e colar código Python diretamente numa macro, sem gravar ações da interface gráfica. Basta criar uma nova macro, editá-la e colar o código. Em seguida, podes salvar a macro da mesma forma que salvas um documento do FreeCAD. Na próxima vez que iniciares o FreeCAD, a macro aparece no item "Macros Instaladas" do menu Macro.

Consulta Como instalar macros para uma descrição mais detalhada.

Repositórios macro

Existem dois locais principais para macros. O primeiro é o repositório oficial de macros revisadas por pares no GitHub. O segundo é a página Macros recipes, de onde podes selecionar macros úteis para adicionar à tua instalação do FreeCAD. Macros de ambos os repositórios podem ser instaladas por meio do Gerenciador de Complementos (Addon Manager), diretamente do FreeCAD.

Informações adicionais

• Executar macro automaticamente na inicialização
• Instalar mais bancadas de trabalho

Tutoriais

Podes instalar extensões manualmente; no entanto, é muito mais simples usar o Gerenciador de Complementos.

• Como instalar macros
• Como instalar bancadas de trabalho adicionais